Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 1 - Appearance Manager Reference / Appearance Manager Types and Constants

Appearance Manager Gestalt Selector Constants

NEW WITH THE APPEARANCE MANAGER

Before calling any functions dependent upon the Appearance Manager's presence, your application should pass the selector gestaltAppearanceAttr to the Gestalt function to determine whether the Appearance Manager is present.

enum {
   gestaltAppearanceAttr   = 'appr'
};

Constant description

gestaltAppearanceAttr

The Gestalt selector passed to determine whether the Appearance Manager is present. Produces a 32-bit value whose bits you should test to determine which Appearance Manager features are available.

The following values are the bit numbers with which you can test for the presence of each feature:

enum {
   gestaltAppearanceExists       = 0,
   gestaltAppearanceCompatMode   = 1
};

Constant descriptions

gestaltAppearanceExists

If this bit (bit 0) is set, Appearance Manager functions are available. To determine which version of the Appearance Manager is installed, check for the presence of the Gestalt selector gestaltAppearanceVersion (see below). If this bit is not set, Appearance Manager functions are not available.

gestaltAppearanceCompatMode

If this bit (bit 1) is set, systemwide platinum appearance is off, turning off auto-mapping of standard System 7 definition functions to their Mac OS 8 equivalents (for those applications that have not called RegisterAppearanceClient). If this bit is not set, systemwide platinum appearance is on, causing auto-mapping of standard System 7 definition functions to their Mac OS 8 equivalents for all applications.

To determine which version of the Appearance Manager is installed, your application should check for the presence of the Gestalt selector gestaltAppearanceVersion.

enum{
   gestaltAppearanceVersion = 'apvr'
};

Constant description

gestaltAppearanceVersion

The Gestalt selector passed to determine which version of the Appearance Manager is installed. If this selector exists, Appearance Manager 1.0.1 (or later) is installed; the version number of the currently installed Appearance Manager is returned in the low-order word of the result in BCD format (for example, version 1.0.1 would be 0x0101). If this selector does not exist but gestaltAppearanceAttr does, Appearance Manager 1.0 is installed.